uniadd TOPKG

This command adds a Dollar Universe object to a package on UVMS.

Syntax:

uniadd TOPKG -area <val> -company <val> -login <val> -node <val> -pkg <val> -pwd <val> -pwdfile <val> [-appl <val>] [-book <val>] [-bv <val>] [-cal <val>] [-calnotpl] [-caltpl] [-class <val>] [-conflict <val>] [-dep] [-dom <val>] [-full] [-help] [-jc <val>] [-mu <val>] [-overwrite] [-que <val>] [-res <val>] [-rul <val>] [-ses <val>] [-ssl] [-trig <val>] [-tsk <val>] [-tskmu <val>] [-tsknotpl] [-tskses <val>] [-tsktpl] [-tskupr <val>] [-upr <val>] [-user <val>] [-vses <val>] [-vupr <val>]

The required parameters are used to target the Dollar Universe environment from which the parameters are to be extracted. The optional parameters are used to filter the objects to be extracted or to define extraction options.

All special characters must be enclosed in quotation marks.

• -appl <val>

  Optional. Filter by Application

• -area <val>

  Mandatory. Dollar Universe Area the object must be extracted from: X (production), S (simulation), I (integration) or A (application)

• -book <val>

  Optional. Filter by runbook

• -bv <val>

  Optional. Filter by business view

• -cal <val>

  Optional. Filter by calendar, all types (template or not)

• -calnotpl

  Optional. Only usable with –cal. For exporting only non-template calendars.

• -caltpl

  Optional. Usable with –cal only. For exporting template calendars exclusively.

• -class <val>

  Optional. Filter by class

• -company <val>

  Mandatory. Dollar Universe Company the objects must be extracted from

• -conflict <val>

  Optional. If Conflicts policy for the object in the package (for a future deployment):

  • O: for overwrite : the existing object will be overwritten by the deployed object (default value).
  • S: for skip : the existing object will not be overwritten when deploying the package.

• -dep

  Optional. Add first level of dependencies for each object added to the package. Equivalent to the Expand button in the package deployment dialog of the UVC Objects and Dependencies page.

  Refer to section "Deployment V6 - V6 Deployment Details - Objects and dependencies".

• -dom <val>

  Optional. Filter by domain

• -full

  Optional. Extracts all the objects without a filter (by default, no object is extracted). For example, the command: -upr="UPR*" -user="*du*" -full
  Extracts:

  • All Uprocs starting with “UPR”
  • All user containing "du"
  • All other objects

  The command: -upr="UPR*" -user="*du*"
  Extracts:

  • All Uprocs starting with "UPR"
  • All users containing "du"

• -help

  Optional. Displays online help

• -jc <val>

  Optional. Filter by job chain

• -login <val>

  Mandatory. UVMS login account. The login account must have read permissions on the Dollar Universe source node and the appropriate UVMS permissions on package administration (see UVMS Role). Security is applied to extract objects and to create the package.

• -mu <val>

  Optional. Filter by Management Unit

• -node <val>

  Mandatory. Dollar Universe node the objects must be extracted from. The login account must have read permissions on the node.

• -overwrite

  Optional. If the object exists already in the targeted file, by default it is not replaced, except if this parameter is specified.

• -pkg <val>

  Mandatory. Name of the package in which the objects are to be inserted. If the package does not exist, the command creates it. The login account must have the UVMS permissions on package administration for this package (see UVMS Role).

• -pwd <val>

  Mandatory if -pwdfile is absent. UVMS login account password
  Incompatible with –pwdfile

• -pwdfile <val>

  Mandatory if -pwd is absent. Full name of the file containing the encrypted password of the UVMS login account. The password must be encrypted with the command uniencryptpwd.
  Incompatible with –pwd

• -que <val>

  Optional. Filter by queue

• -res <val>

  Optional. Filter by resource

• -rul <val>

  Optional. Filter by rule

• -ses <val>

  Optional. Filter by session

• -ssl

  Optional. Use SSL mode

• -trig <val>

  Optional. Filter by trigger

• -tsk <val>

  Optional. Filter by task, all types (template or not)

• -tskmu <val>

  Optional. Filter by Management Unit of the tasks

• -tsknotpl

  Optional. Only usable with –tsk. For extracting non-template tasks only

• -tskses <val>

  Optional. Filter by session of the tasks

• -tsktpl

  Optional. Only usable with –tsk. For extracting template tasks only

• -tskupr <val>

  Optional. Filter by Uproc of the tasks

• -upr <val>

  Optional. Filter by Uproc. If an Uproc containing a password variable is exported, the XML file contains the encrypted value.

• -user <val>

  Optional. Filter by user / submission account

• -vses <val>

  Optional. Filter by session version

• -vupr <val>

  Optional. Filter by Uproc version

If the node does not exist, the command aborts with an error message.

If an error occurs for one object, a message is displayed but the command still adds the object. The final return code will be in error.

If the package already exists, objects are added to the current content.

Also refer to section Shared Characteristics.

Example: